zQuickDraw GX PrintingContents Figures, Tables, and ListingsAbout This BookFormat of a Typical Chapter Conventions Used in this Book
Special FontsTypes of Notes
Empty StringsThe Development EnvironmentFor More Information*Introduction to Printing With QuickDraw GX About Printing With QuickDraw GXCore Printing FeaturesGFigure 1-1 Dragging a document to a desktop printer icon on the desktop*Customizing QuickDraw GX Printing Features:Figure 1-2 Printing a document containing multiple formatsAdvanced Printing FeaturesAFigure 1-3 Printing the pages of a document on different printers@Figure 1-4 A user-defined paper type printed on letterhead paper1QuickDraw GX Print Objects and Collection Objects%Figure 1-5 QuickDraw GX print objects0Job Object, Format Object, and Paper Type Object<Job Collection, Format Collection, and Paper Type CollectionManipulating Print ObjectsBFigure 1-6 Manipulating the job object in response to user actionsMessages and Printing.Figure 1-7 Message handlers in a message chain1Figure 1-8 Overriding the GXPrintingEvent message
Printing and the User InterfaceQuickDraw GX Menu Commands2Figure 1-9 Printing menu commands in the File menu'QuickDraw GX Movable Modal Dialog BoxesDesktop Printers6Figure 1-10 Default QuickDraw GX desktop printer icons8Figure 1-11 The desktop printer window for a LaserWriter8From Macintosh Printing Manager to QuickDraw GX PrintingPrinter Drivers!System Printer to Default Printer Print Record to Print Object'Spool File to Portable Digital DocumentCore Printing Features About Core Printing Features=Figure 2-1 Objects needed to implement core printing featuresCore Print ObjectsJob Object PropertiesFigure 2-2 The job objectFormat Object Properties Figure 2-3 The format objectPaper-typeObject Properties Figure 2-4 The paper-type objectEdit Menu Structure Using Core Printing Features"Initializing QuickDraw GX Printing.Creating a Job Object for a Printable Document:Listing 2-1 Creating a job object for a printable documentError Handling9Listing 2-2 Polling for errors after individual functions8Listing 2-3 Polling for errors after groups of functions*Supporting QuickDraw GX Print Dialog Boxes3Listing 2-4 Overriding the GXPrintingEvent function%Printing Documents Using QuickDraw GX Printing Pages as Single Shapes>Listing 2-5 Printing a document using the GXPrintPage function"Printing Pages by Capturing Shapes^Listing 2-6 Printing a document using the GXStartPage, GXDrawShape, and GXFinishPage functions(Saving A Job Object With a Document File&Saving a Job Object in a Single HandleEListing 2-7 Using the GXFlattenJobToHdl function to save a job object/Saving a Job Object Using a Flattening Function@Listing 2-8 Using the GXFlattenJob function to save a job object1Disposing of a Job Object When Closing a Document?Listing 2-9 Disposing of a job object when you close a document/Retrieving a Job Object When Opening a Document%Retrieving a Job Object From a HandleNListing 2-10 Using the GXUnflattenJobFromHdl function to retrieve a job object6Retrieving a Job Object Using an Unflattening FunctionGListing 2-11 Using the GXUnflattenJob function to retrieve a job object*Obtaining Information From a Format ObjectEListing 2-12 Using the GXGetFormatJob function to obtain a job object5Listing 2-13 Using the GXGetFormatDimensions function*Displaying QuickDraw GX Print Dialog Boxes$Displaying the Page Setup Dialog Box$Figure 2-5 The Page Setup dialog box-Figure 2-6 The expanded Page Setup dialog box1Listing 2-14 Displaying the Page Setup dialog box Displaying the Print Dialog Box Figure 2-7 The Print dialog box(Figure 2-8 The expanded Print dialog box-Listing 2-15 Displaying the Print dialog box #Supporting Printing From the Finder[Listing 2-16 Responding to the Print Documents Apple event and specifying an output printer#Printing Non-QuickDraw GX Documents8Listing 2-17 Converting a print record into a job object Core Printing Features ReferenceData Types and Constants Gestalt Selector for PrintingQuickDraw GX Print ObjectsEdit Menu LocationDialog Box Results Functions.Initializing and Terminating Printing FeaturesGXInitPrintingGXExitPrintingHandling Errors
GXGetJobError
GXSetJobError!Creating and Managing Job ObjectsGXNewJob GXDisposeJobGXFlattenJobToHdl GXFlattenJobGXUnflattenJobFromHdlGXUnflattenJobPrinting Using QuickDraw GXGXSelectJobOutputPrinterGXGetJobPageRange
GXStartJob GXPrintPage GXFinishJob GXStartPage GXFinishPage&Obtaining Information on Print ObjectsGXGetJobFormatGXGetFormatJobGXGetFormatDimensions0Displaying the Page Setup and Print Dialog Boxes GXInstallApplicationOverrideGXPrintingEvent messageGXJobDefaultFormatDialogGXJobPrintDialogConverting a Print RecordGXConvertPrintRecord Application-Defined FunctionsFlattening a Job ObjectUnflattening a Job Object!Summary of Core Printing Features,Page Formatting and Dialog Box Customization2About Page Formatting and Dialog Box CustomizationCollection ObjectsThe Job Collection Figure 3-1 The job collectionThe Format Collection Figure 3-2 The format collectionThe Paper-Type Collection$Figure 3-3 The paper-type collectionPage FormattingRFigure 3-4 A three page document, its corresponding job object, and format objectsManipulating Format ObjectsEFigure 3-5 Manipulating the format object in response to user actionsMapping for Format ObjectsForms and Format Objects&Figure 3-6 An application using a form!Halftoning and Format CollectionsDialog Box Customization<Figure 3-7 The expanded Print dialog box with an added panelDefault Dialog Box Panels Figure 3-8 The Print Time panel Figure 3-9 The Paper Match panel Messages and Dialog Box Panels1Listing 3-1 A 'ppnl' resource definition template Automating Panel Information2Listing 3-2 An 'xdtl' resource definition templateUsing Collection Objects"Adding Data to a Collection Object8Accessing Job, Format, and Paper-Type Collection ObjectsCListing 3-3 Accessing copies information stored in a job collection
Using Format Objects&Tracking a Format Object’s Owner Count1Creating a Format Object for a Page in a Document,Figure 3-10 The Custom Page Setup dialog box5Figure 3-11 The expanded Custom Page Setup dialog boxNFigure 3-12 A four-page document in which page two uses a unique format object=Listing 3-4 Creating a format object for a page in a document/Cloning a Format Object for Pages in a DocumentXFigure 3-13 A four-page document in which pages two and three use the same format object?Listing 3-5 Cloning a format object for two pages in a document5Disposing of a Format Object for a Page in a DocumentXFigure 3-14 A four-page document in which pages two and three use unique formats objectsXListing 3-6 Disposing of a format object for a page in a document and creating a new one!Using Special Formatting Features Using Forms With Format Objects,Listing 3-7 Adding a form to a format object3Storing Halftone Information in a Format Collection?Listing 3-8 Storing halftone information in a format collection2Copying a Format Object For Use in Other Documents?Figure 3-15 Moving a format object from one document to another?Listing 3-9 Moving a format object from one document to another0Accessing Information on Specific Format Objects#Obtaining a Format Object’s Mapping0Listing 3-10 Obtaining a format object’s mapping-Obtaining a Format Object’s Paper-Type ObjectkFigure 3-16 A three-page document and its corresponding job object, formats objects, and paper-type objects:Listing 3-11 Obtaining a format object’s paper-type object'Scanning Through a Job’s Format Objects+Listing 3-12 Using the GXForEachJobFormatDo@Listing 3-13 Obtaining scaling information on each format object.Associating Format Objects With Document PagesXListing 3-14 Saving format object to document page correspondence in a format collection Listing 3-15 Filling the handle^Listing 3-16 Retrieving format object to document page correspondence from a format collection%Customizing QuickDraw GX Dialog Boxes Adding Panels to Dialog Boxes#Listing 3-17 Setting up a new panelSetting Up Dialog Resources#Listing 3-18 Sample ‘ppnl’ resource#Listing 3-19 Sample ‘DITL’ resource#Listing 3-20 Sample ‘CNTL’ resource#Listing 3-21 Sample ‘xdtl’ resource#Listing 3-22 Sample ‘MENU’ resource6Page Formatting and Dialog Box Customization ReferenceData Types and Constants*Loop Status Information For Format ObjectsCollection Item CategoriesCollection Item ID-Job Collection Item for Print-Job Information-Job Collection Item for Collation Information*Job Collection Item for Copies Information.Job Collection Item for Page-Range Information+Job Collection Item for Quality Information4Job Collection Item for File-Destination Information1Job Collection Item for File-Location Information/Job Collection Item for File-Format Information.Job Collection Item for File-Fonts Information.Job Collection Item for Paper-Feed Information-Job Collection Item for Tray-Feed Information/Job Collection Item for Manual-Feed Information4Job Collection Item for Standard Mapping Information3Job Collection Item for Special Mapping Information/Job Collection Item for Bin-Mapping Information#Job Collection Item for {to define}/Job Collection Item for Print-Panel Information0Job Collection Item for Format-Panel Information+Format Collection Item for Lock Information.Format Collection Item Orientation Information*Format Collection Item Scaling Information.Format Collection Item Direct-Mode Information+Format Collection Item Halftone Information5Format Collection Item for Page-Inversion Information;Format Collection Item for Horizontal Page-Flip Information9Format Collection Item for Vertical Page-Flip Information5Format Collection Item for Precise-Bitmap Information4Paper-Type Collection Item for Base-Type Information2Paper-Type Collection Item for Creator Information0Paper-Type Collection Item for Units Information0Paper-Type Collection Item for Flags Information2Paper-Type Collection Item for Comment Information)QuickDraw GX Dialog Box Panel Information Functions(Creating and Manipulating Format Objects GXNewFormatGXDisposeFormat GXCopyFormat
GXCloneFormatGXCountJobFormatsGXCountFormatOwnersGXForEachJobFormatDo%Manipulating Format Object PropertiesGXGetFormatMappingGXGetFormatPaperTypeGXGetFormatFormGXSetFormatFormGXChangedFormat+Displaying the Custom Page Setup Dialog BoxGXFormatDialog%Customizing QuickDraw GX Dialog BoxesGXJobPrintDialog message GXJobDefaultFormatDialog messageGXFormatDialog messageGXHandlePanelEvent messageGXFilterPanelEvent messageGXSetupDialogPanelGXGetJobPanelDimensionsGXEnableJobScalingPanel Accessing Collection ObjectsGXGetJobCollectionGXGetFormatCollectionGXGetPaperTypeCollection Application-Defined Functions Looping Through Format ObjectsDialog-related ResourcesThe Panel ('panl') Resource.The Execute Dialog Item List ('xdtl') Resource$The Printing Alert ('plrt') Resource'Figure 3-17 The printing alert resource,Table 3-1 Printing alert versions(continued)7Table 3-2 Printing alert icon IDs(continued)(continued)@Table 3-3 Printing alert default button string values(continued)?Table 3-4 Printing alert cancel button string values(continued)7Summary of Page Formatting and Dialog Box CustomizationAdvanced Printing Features About Advanced Printing FeaturesAbout Printer Objects Figure 4-1 The printer object Printer and Printer-Driver Types*Table 4-1 Printer and printer driver typesPrinter View DevicesAbout Print File Objects Figure 4-2 The print file objectAbout Synonyms(Table 4-2 QuickDraw GX Printing Synonyms+General-Purpose PostScript Operator Synonym&PostScript Control Information SynonymSet Dash SynonymLine Cap SynonymHalftone SynonymPattern SynonymCubic SynonymsAbout Printing Modes*Table 4-3 Printer and printer driver types'Formatting for the Text Job Format Mode'Table 4-4 Job format mode query options#About Pen Tables for Vector DevicesAbout ColorSync Routines Using Advanced Printing Features#Using Advanced Job Object Functions@Obtaining Printer and Printer Driver Information on a Job ObjectQListing 4-1 Obtaining the names and creator types of a printer and printer driver;Getting and Setting the Reference Constant for a Job Object@Listing 4-2 Setting the job object’s reference constant propertyAListing 4-3 Getting the job object’s reference constant protperty Copying Job Object Information*Listing 4-4 Copying job object information Updating Job Object Information7Listing 4-5 Updating a job when receiving resume events Working With Printer Objects"Obtaining Printer Objects and Jobs7Retrieving and Counting a Printer Object’s View DevicesFObtaining Printer and Printer Driver Information from a Printer Object Manipulating Print File Objects Defining the Print File Object'Opening and Closing a Print File Object3Listing 4-6 Opening and closing a print file objectSaving a Print File Object*Obtaining a Print File Object’s Job Object Viewing Print File Object Data'Listing 4-7 Reading a print file object"Counting the Pages in a Print File*Adding or Deleting Print File Object Pages Defining Different Paper Sizes,Creating and Disposing of aPaper-Type Object,Listing 4-8 Creating a new paper type object'Obtaining Paper Type Object Information0Listing 4-9 Obtaining a paper type object’s name$Obtaining the Dimensions Paper Type HListing 4-10 Obtaining page and paper rectangles for a paper type object6Scanning Paper Types Objects Available to a Job Object=Listing 4-11 Executing a procedure for each paper type object=Listing 4-12 Executing a procedure for each paper type object!Implementing Direct Mode PrintingUsing Synonyms8Retrieving the Color Profile and Color Set for a PrinterCListing 4-13 Retrieving the printer’s color profile and color space,Listing 4-14 Using the printer’s color space"Determining a Printer’s Resolution/Listing 4-15 Determining a Printer’s Resolution$Advanced Printing Features ReferenceData Types and ConstantsJob Object Direct Modes Status Dialog Box Information%Paper Type Object Mapping Information)Paper Type Object View Device Tag ObjectsSynonym Information Functions*Working With Advanced Job Object Functions Manipulating Printer Objects,Working With QuickDraw GX Print File ObjectsWorking With Paper Types Formatting for Specific DevicesColor Profile Functions8Table 4-5 The actions of the GXSetPrinterProfile message7Table 4-6 The actions of the GXSetFormatProfile message Application-Defined Functions(Looping Through a Printer’s View Devices#Looping Through a Job’s Paper Types%Summary of Advanced Printing FeaturesGlossaryIndex
